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PROGRAM REG ISTRATION FORM. 


SEND FORM TO: 



T.M. 



P.O.Box 10827 St. Louis, Mo. 63129 


PROGRAM NUMBER 1- jl DATE OF PURCHASE. 

STORE NAME__ 

ADDRESS_ 

CITY, STATE, ZIP_ 


PURCHASER_ 

ADDRESS_:_ 

CITY, STATE, ZIP. 


PLEASE ANSWER THE FOLLOWING SO THAT BETTER 

ANSWER YOUR QUESTIONS SHOULD YOU HAVE PROBLEMS» 


PRINTER TYPE--- 

INTERFACE TYPE____ 

MODEM (Y/N)_ATARI 400 OR 800--- 

MEMORY SIZE_ 

OTHER HARDWARE OR MODIFICATIONS TO YOUR ATARI: 


(MAIL WITHIN 10 DAIS OP PURCHASE) 
THE OPPOSITE SIDE MUST BE SIGHED 



(over) 
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THIS SIDE MUST BE SIGNED TO REGISTER YOUR PROGRAM 


SOFTWARE LICENSE AGREEMENT 

. 

LJK Enterprises Inc. (hereafter referred to as LJK) has sold or 
will sell to the undersigned ("purchaser’') magnetic diskettes 
containing original data and programs expressed and arranged in 
electronically coded and magnetically stored form. LJK has sold 
or agreed to sell the diskettes only upon the condition that the 
purchaser acknowledge and agree to the following. By signing 
the Agreement, the purchaser so acknowledges' and agrees. 

1. The purchaser understands and acknowledges that the data and 
programs recorded on the diskettes are copyrighted original 
works of authorship and are unique proprietary material of 
LJK • 

2. The purchaser will not copy or reproduce any portion of the. 
data or programs recorded on the diskettes, nor allow others 
to do so. 

i 

3. The purchaser will not create or prepare any derivative 
materials from the data and programs recorded on the 
diskettes, nor will the purchaser translate such data and 
programs into another computer system or create any 
combination which includes any portion thereof, nor allow 
others to do so. 

4. The purchaser will not sell, transfer, distribute, or 
display to the public any copy or reproduction of the data 
or programs recorded on the diskettes or any materials 
derived therefrom or translation or adaptation thereof to 
any person or organization, nor allow others to do so. 

5. The purchaser acknowledges and agrees that the purchaser 
will be liable for damages to LJK for any violation of this 
Agreement. 

6. The purchaser acknowledges that LJK makes no warranty or 
representation whatsoever with respect to the data an^ 
programs recorded on the diskettes, and that neither LJK nor 
any author thereof will ±>e responsible for error or 
omissions therein or erroneous or inaccurate application of 
any results from the use thereof. 

LJK ENTERPRISES, INC. 

PURCHASER_ 


EDIT 6502 <TM> 


ASSEMBLER, EDITOR, SYMBOLIC DISASSEMBLER, 
AND MACHINE LANGUAGE MONITOR FOR THE 
ATARI 800 AND ATARI 400 
COPYRIGHT <C> 1981 


LJK ENTERPRISES, INC. 

P. O. BOX 10827 
ST. LOUIS, MO. 63129 
(314) 846-6124 


VERSION 1.0 




-NOTICE-LJK ENTERPRISES, INC. MAKES NO WARRANTY OF ANY KIND WITH 
REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTY OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE. LJK shall not be liable for any errors or omissions 
contained herein or for incidental or consequential damages in 
connection with the furnishing, performance, or use of this 
material.NO PART OF THIS PROGRAM OR MANUAL MAY BE COPIED, 
PHOTOCOPIED, FOR IN ANY WAY REPRODUCED WITHOUT EXPRESSED WRITTEN 
PERMISSION OF LJK ENTERPRISES, INC. COPYRIGHT 1980, 1981 , LJK 
ENTERPRISES, INC. 


EDIT 6502 is a trademark of LJK Enterprises, Inc. 

Atari, Atari 400, and Atari 800 are trademarks of Atari 
Computer, Inc. 
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AUTHOR'S PREFACE 

EDITORIAL — ELEMENTS OF GOOD PROGRAMMING 

When asked to lecture on assembly language programming two of 
the most often asked questions I get is "What are some good 
techniques in programming the 6502?" and "Most assembler 
manuals expect you to know too much before you start, why don't 
they have tutorials?" In response to the second question, I 
feel that there are a number of books in the marketplace that 
explain, in great detail, what is required for good assembly 
language programming. The problem in the beginner getting the 
most out of it leads back to "the first question, where my 
overwhelming response is to be a good programmer the first 
requirement is to KNOW THE INSTRUCTION SET OF THE PROCESSOR YOU 
ARE WORKING WITH. And by knowing the instruction set, I mean, 
knowing exactly what each instruction does for you. I can pick 
up almost any magazine and see articles with assembly listings 
that demonstrate my point (and these people must have some 
proficiency or else they wouldn't be published). A typical 
example might be: 

LDA FLAG 
CMP #0 
BEQ OK 

This code will always work, but if the programmer completely 
understood the instruction set of the 6502 he would KNOW that 
the LDA FLAG instruction did, indeed, either set or clear the 0 
flag in the 6502's status register and that the CMP #0 
instruction is redundant. This may seem a trivial matter to 
some of you; but, compounding this type of thing several times 
in code and not taking advahtages of other 'features' of the 
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microprocessor by not understanding exactly what happens is what 
generally is the cause of good, concise code to be turned into 
slow and long code. I could demonstrate countless examples just 
like the one above on this subject. 

Wr 

With the memory size of systems increasing this point DOES NOT 
GO AHAY1 The philosophy should be the majority of the memory 
(as much of it as possible) should go to the user for USER DATA 
rather than to expand the program. There are only two viable 
exceptions to this, those being 1 - when there is no data and 2 
- when shrinking the program costs the user something. The 
program is written for the USER, not the programmer. 

Most of the code I see is not geared this way. It generally 
takes more time and organization to write user oriented codfe, 
but that is what it is all about. We call it designing a good 
user interface. Others call it human engineering. To me, it is 
a good practice to write code, even that is just for yourself, 
to be geared toward someone who is not familiar with the 
machine. 

To observe this phenomenon, just take any program that you've 
written and place someone in front of the machine who has no 
knowledge of the machine, tell 'then to run the program and WALK 
AWAY FROM THE MACHINE. If the program is designed with the user 
interface foremost in mind, they should be able to 
program without assistance ! This is a very hard thing for the 
programmer to do. He or she will want to help them along to 
warn them of pitfalls in the system? but that is what the te^t 
is all about. 
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I highly recommend that people flowchart their programs and 
spend a great deal of time in organization of the program before 
they ever sit down in front of a machine. This organizing time 
should be though of in terms of how the user will be perceiving 
and using the program and the possible things that they might do 
that the program never intended them to do (this is the hard 
part, you can never think of all the ways). Nothing is more 
frustrating to the user than a program that crashes for no 
reason that they can discern. In this organizational time 
methods of actual coding should be thought out so that by the 
time you sit down at the machine to write the code, it is merely 
an exercise in typing. 

All of the aforementioned material deals with programming in 
general. To get specific to the 6502 and Atari, one of the key 
things to understand is that the status register controls all. 
All of your decisions are based on it. Pay particularly close 
attention as to how each instruction may affect the status. Lay 
out your entire memory map of the system before yog start out 
coding including temporaries, zero page allocation and user data 
space. 

You may notice that this particular program is less user 
oriented than other LJK programs which may seem a contradiction 
in what we have been discussing. It is not, however. As this 
program is geared toward a USER who would find menus and the 
like a retardant doing things in an efficient manner. The 
program is geared to a more knowledgeable user. 
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FOR THE BEGINNER 

Most beginners are familiar with another programming language 
such as basic. The key thing they seem to forget is that theifc 
did not learn that language overnight. Remember the first day* 
you brought your Atari home and sat down and said "What does 
PRINT mean?" Computers are excellent educational tools in that 
you can try something on the machine without worrying about 
destroying the hardware. If you totally crash the system you 
can just turn off the machine and reboot it. Just as you did 
when first learning, write small pieces of code and TRY THEM. 
The logic of assembly language is very similar to other 
programming languages, it is only a matter of learning new 
nomenclature and, in most cases, learning that in assembly 
language, you must provide the memory allocation. My 
recommendation on early routines is to write something that will 
VISUALLY show you its results. It is one of the most rewarding 
ways to experiment and learn. 

FOR THE INTERMEDIATE PROGRAMMER 


The best way to learn new techniques is to steal them. Before I 
get in trouble, let me say that you shouldn't steal peoples 
code, but examine the techniques they have used to perform 
tasks. There is nothing wrong with taking any piece of source 
listing that you can find and read through and understand 
exactly what the author was doing. This is an excellent way of 
finding new and better ways of performing tasks. Store any new 
technique you may see a way for that future time when it just 
happens to fit the bill. 
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FOR THE ADVANCED PROGRAMMER 


Before you read this, you should read the other two sectionsl 
The key thing to being a good programmer is to always look to 
improve. Ego can oftentimes get in the way of this. The very 
best of programmers don't claim to know it all and are always 
looking for new and better ways of doing things. Another key 
point is to not come in looking at things with a preconceived 
notion. The single biggest stifler of creativity is 
preconceived notions. Let your imagination run with ideas and 
keep it free of constraints that you think might be there. 


Ken Leonhardi 

LJK Enterprises, Inc. 
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"A 
"B 
" E 
"F 
<- 

-> 


CLEAR 

INSERT 

"DELETE 

SDELETE 


BACK S 
TAB SET 
TAB CLR 
TAB 


<CR> 

CAPS LOWR 
logo key 
ESC 

BREAK 


NOTE: ~ = 
s = 


KEYBOARD FUNCTIONS 
INPUT CONTROLS 

Exit entry of line at current cursor position. 

Go to the beginning of the line. 

Go to the end of the line. 

Find character after cursor location. 

Move the cursor back 1 space (non-destructive 
backspace). 

Advance the cursor by copying over the character from 
the screen and adding it to the input buffer. 

Move the cursor up. This will not change your 
position in the input buffer, but will only move the 
cursor up. 

Move the cursor down. Again, this will not change 
your position in the input buffer, but will only move 
the cursor down. 

Clear entire screen 

Insert one character (space) at cursor location. 
Delete character at cursor location. 

Cancel entire input line and start over. The input 
buffer will be cleared and you will be placed on a 
new line (with prompting) for new input. 

Delete previous character typed into input buffer. 
Clear screen from cursor location to end of line. 
Clear screen from cursor location to end of screen. 
Tab cursor over to next multiple of 8 column. This 
will copy the screen contents into input buffer over 
the range of characters it copies 
Exit entry of input line by accepting entire line. 

Set lower case enter mode. 

Toggle input inverse flag off and on. 

Esc allows for entering and viewingany control 
character into the input buffer. 

Abort operation and return to outer level command. 


CONTROL 

SHIFT 
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COMMANDS SHEET 


INPUT/OUTPUT COMMANDS 


LOAD -DEV:FNAME.EXT" 

BLOAD [ADRl] "DEV:FNAME.EXT" 
BRUN [ADRl] "DEV:FNAME.EXT" 
BSAVE ADRl,ADR2 "DEV:FNAME.EXT 
XI0 ADRl , ADR2 "DEV: 


2 * 

MERGE "DEV:FNAME.EXT" 

SAVE "DEV:FNAME.EXT" 

DIR [D] 

DOS NONE 


SYSTEM MANAGEMENT 


NEW NONE 
LEN NONE 
HIM [ADRl] 

TABS [LNOl][,LN02][,LN03] 

HELP NONE 

EDITTING COMMANDS 


CLR NONE 

LOM [ADRl] t 

SYMB [ADRl] 

DATE NONE 


ADD NONE 
INS LNOl 

FIND [LNOl] [ r LN02] "STRING1" 

CHNG [LNOl][ t LN02] "STRING1"STRING2" 
SRCH [LNOl][ , LN02] "STRING1"STRING2" 
TABLE NONE 


EDIT LNOl [,LN02] 

DEL LNOl [,LN02] 

LIST [LNOl][,LN02] 
PLIST [LNOl][,LN02] 
COPY LN01,LN02 TO LN03 


V 


MODE CHANGING 


ASM [PLTSWA"] 

DIS ADRl,ADR2 "STRING1" 


MON NONE 
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MONITOR COMMANDS 


HEX RESULT (16 BIT) @ 
DISPLAY (HEX AND ASC) G 
LIST (DISASSEMBLE) 

HEX SEARCH 

ASC STORE Z 
RETURN TO CCP # 
WRITE SECTOR R 
TURN ON PRINTER N 
STEP T 
DOS M 
VERIFY U 
PARAMETER SEPARATOR < 


DECIMAL RESULT 
GO 

ASC SEARCH 

HEX STORE 

FILL MEMORY 

DISPLAY REGISTERS 

READ SECTOR 

TURN OFF PRINTER 

TRACE 

MOVE 

USER 

PARAMETER SEPARATOR 
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I. INTRODUCTION 

EDIT 6502 consists of a co-resident assembler, symbolic 
disassembler, text editor, and machine language monitor for the 
Atari 400 and Atari 800 computers. Assemblies and disassemblies 
can be linked. You are in no way limited in the length, or 
memory size of the program you are working on. The machine 
language monitor is very comprehensive in allowing step, trace, 
read and write a sector to disk, ASCII dumps of memory, and many 
other commands. The disassembler allows predefinition of labels 
and differentiation between 6502 code, ASCII strings, hex data, 
word data, and stack data. EDIT 6502 allows you to disassemble 
6502 machine language programs, edit, assemble, execute, debug, 
reedit and go on without ever having to reload a program. This 
package works well for anyone from the neophyte to the 
professional programmer. 

The command structure is set up very similarly to the immediate 
mode in Basic to allow the beginner to make the transition from 
basic to assembly language programming very comfortably. 

This manual is not intended to be an instruction course on 
assembly language programming. Novice assembly language 
programmers are encouraged to consult one of the many books in 
the marketplace on the subject. 


< 1 > 



EDIT 6502 


II. LINE INPOTS 


Inputting a line of text is different in EDIT 6502 than in 
standard Atari operation. Additional editing key functions are 
^Tways at your command. It is possible to go to the end or back 
to the beginning of a line of the program. Inserting a 
character, deleting a character, or searching for a character 
may also be done. You have the option of cancelling a line of 
the program, going to the end of the line or exiting the line. 
The additional line input changes are only one of the added 
editing capabilities of EDIT 6502. You also have the advantage 
of being able to pause the operation by hitting the space bar. 
While repeatative hitting of the space bar will cause the 
program to scroll a line at a time. To abort an operation do a 
[BREAK]. Following is a list of the useful editing functions 
that will make your use of EDIT 6502 far easier than any other 
assembler program available today. 


TABLE I 


1 , 

2 . 

3, 

4. 


5, 

6 , 


A] 

B] 


KEYBOARD FUNCTIONS 

will end the line input at that point 


in the input 

will move the cursor to the beginning of the input 


E] 

F] 


the input line, 
(only) -search, 
not found, the cursor will go to the 
line. The search can be called 


will move the cursor to the end of 
(char) will find char on a forward 
character is 
the input 


[CTRL 
line. 

[CTRL 
line. 

[CTRL 
[CTRL 
If the 
end of 
recursively 

[<_] will backspace the cursor one position on the input 

line. ... 

[->] will copy one character from the video screen, place 

it in the input buffer, and advance the cursor. 

.lower case mode, the character copied over 
converted to lower case if it is alpha. , 

[|J will move the cursor up one line. This will not change 


(going over and over forward for the same 


If” 
will 


in 

be 
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8 . 

9. 

10 . 

11 . 

12 . 

13. 

14. 

15. 

16. 

17. 

18. 


19. 

20 . 


your position in the input buffer 
cursor up one line. 

[|] will move the cursor down one 


but will only move the 


cursor up one .Line. . 

[|] will move the cursor down one line. Again, this 
not change your position in the input buffer, but will on ? 

move the cursor down one line. _ 

[INSERT] will insert one space at the cursor ^locati ^ ^ ^ ^ 


Jfc. 

location on 


the screen that can later be repiaceo witn — 

[CTRL DELETE] will delete one character from the input line 

at the current cursor location. . _ rnui(1p a 

[SHIFT DELETE] will delete the entire line and pr 

new line for input. . incur 

[BACK S] delete previous character typeo into the i p 

iCR] e will end the line of input at the current end of line. 
All input after the cursor that is on the current line 


at the cursor location or 
replaced with another 


the input 


[TAB^will act as a tab to the next multiple of 8 column 
location. If there are characters on the screen, they 
be copied over with a screen read. ' 

[TAB SET] Clear screen from cursor location to tne eno 


[TAB SET] 
the line. 
[TAB CLR] 


location to the end of 


[TAB CLR] Clear screen from cursor location to the end of 
the screen. 

[BREAK] will return to outer level command (Dreax; . 

[logo key] will toggle on and off an input inverse flag, 
rhis will allow the most significant bit of the character 
to be set if the flag is set. This will allow the input of 
Low bit ASCII directly into the text file. Please notice 
-hat this is not true inverse video basis a 40 column Atari 
In that inverse on the Atari is actually the control 
r epresentation on Alpha characters. Under Edit 6502? al 
Inverse characters will appear as inverse video. 

[CAPS LOWR] will set the Atari into upper/lower case input. 
[ESC] will allow the entry and viewing of any into the- 

Lnput buffer. 


command (break) . 
an input inverse flag. 
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III. CONTROL OP OUTPUT 

When text is being output (either to the video screen or 
the printer), the keyboard is being polled for a keystroke. 
If a key is pressed, the output is paused until another key 
is pressed. If the key is the space bar, the output will 
stop at the end of the next line, just as if a key had been 
pressed. In this way, listings a line at a time by hitting 
the space bar every time a new line is desired. Pressing 
[BREAK] during output will return you to the outer command 
level. There are places where no output is going on (as in 
pass 1 of an assembly) . In these cases, the keyboard is 
polled for the [BREAK] only. 

IV. INSTALLING YOUR EDIT 6502 CARTRIDGE 

The first thing you must do in order to install your EDIT 
6502 cartridge is to open the compartment where they are 
placed. Pull the lever that holds the lid down, this will 
release the lid. If you have an Atari 800 you will see two 
cartridge wells. IF you have an Atari 400 you will see 
only one cartridge well. If there are any cartridges in 
the machine now, take them out. Before handling the EDIT 
6502 cartridge, it is wise to touch the metal part of the 
cartridge well. This will discharge any static electricity 
you may have on you during handling. 

Hold the EDIT 6502 cartridge so that the "<- LEFT" is 
pointing to the left and the title EDIT 6502 is facing you. 
Press the cartridge gently into the cartridge well until it 
will go no further. Close the lid to the cartridge well(s) 
until it snaps shut. There you have it, your Atari is now 
ready to run the EDIT 6502 system. 
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V. STARTING THE SYSTEM 

If you will be disassembling, you should boot from the disk 
provided with the package? otherwise, yol L can koot f . r *°K *2 
disk containing the operating system. The disk with th| 
package will load the disassembler in memory f J°® 

$2100 and will adjust the memory parameters °* ^y^tem 

accordingly. Since the disassembler resides ^ere it does, 
it is not possible to have the disassembler and the serial 
driver in the system simultaneously* 

Upon a successful disk boot (or on power up if you have no 
disk), you will be prompted to input the current date. it 
is important to enter this for YODR reference as to w 

you were working on a particular file. The enter 

input is not a concern to the system as long as you> ent 
something , the program will not allow you to DUSt^hU 

return. The date will be truncated off aft arr 4^ pn tallv 
if you were to enter more than that. If you accidental y 
enter the wrong date, it can be changed from the command 
control processor at any time. 
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VI. THE COMMAND CONTROL PROCESSOR 

The Command Control Processor is very similar in structure to 
the immediate mode in Basic. You will be prompted with a "C" 
(for Command) followed by a The syntax of the Command form 
at this point is such that it may or may not be followed by 
parameters. The use of incorrect commands or parameters will be 
signaled with error messages. There are 32 EDIT 6502 commands 
in addition to 22 monitor commands. Commands are broken down 
into four different types, which are: Input/Output, System 
management, Editing, and Mode changing. Before going through 
each of the commands and command types, some syntactical ground 
rules for the nomenclature used in this manual to represent them 
is necessary: 


1. The syntax for expressing commands in a line is represented 
as COMMAND parameter, COMMAND [parameter], or COMMAND none. 
When the word "parameter" is expressed without brackets, it 
is a required parameter. When it is expressed with 
brackets it is an optional parameter that may be entered 
but is not required. The required parameter of NONE 
indicates that no parameter may be entered. 

2. There can be any number of spaces between the COMMAND and 
the parameter as they are ignored by the system. The 
spaces may be placed according to your discretion in terms 

of readability. . 

3. All commands must be entered in upper case with no spaces 
between any of the letters in the command. 
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TABLE IV 

PARAMETER SYRTAX 

ADRl r ADR2 - Hexadecimal addresses (no $ required). 
Input may be in decimal if the number is preceded by 3 
period (.) or binary if the number is preceded by a 
percentage symbol (%) . 

LNOl, LN02, LN03 - Decimal number, usually line numbers. 

DEV : FNAME.EXT - A valid device specification (as in 
standard Atari operation) and a filename with an 
extension. If the device is a cassette or other, 
non-named device, no filename is needed. 

STRING1 , STRING2 - ASCII strings of text. 

PLTSWA" - Assembly time options (see Assembly section 
for details) . 

" (delimiter) - delimiting character. Can usually be 
any character other than space. Only when mentioned 
will it have to be a " or a '. 

VALUE - An assembler value. Default radix is decimal, 
hex supported when preceded by a $, and binary supported 
when preceded by a %. The program counter may be used 
by using an asterisk *, and ASCII data can be used by 
using a " or a '. Non-spaced separation of +-*/ will 
perform non-precedented math functions. If the value is 
called for as a zero page value (<256), an automatic mod 
256 will be performed on the result. Using the greater 
than symbol (>) will perform a divide by 256 on the 
final result. 


< 7 > 


EDIT 6502 


VII. INPUT/OUTPUT COMMANDS 


The syntax and entry order of parameters for DOS type commands 
follows the syntax of Atari DOS 2.OS. 


1. LOAD "DEV:FNAME.EXT" - Load the source file FNAME. EXT into 
memory at the beginning of text area in memory. This 
command will erase any source file currently in memory. 

2. MERGE "DEV: FNAME. EXT" - Load a source file from disk, but 
append it to the end of the file currently in memory. 

3. SAVE "DEV:FNAME.EXT" - Save the file currently in memory to 
disk under the name FNAME.EXT. 

4. DIR [D] - Read the disk directory and display it on the 
video screen. There will be 2 entries per line. 

5. BLOAD [ADR1] "DEV:FNAME.EXT" - Load binary (or object) file 
to memory. If no address is given, the file loads in to 
memory where it was saved. If the address is given, the 
file loads at that address. 

6. BRUN [ADRl] "DEV:FNAME.EXT" - Load and execute a binary 
file. All parameters of bload are in effect here. 

7. BSAVE ADRl,ADR2 "DEV:FNAME.EXT" - Save binary file to disk. 
Starting address is ADRl and the ending address is ADR2. 

8. DOS - Load the Atari DOS utilities package. 

9. XIO ADRl,ADR2 "DEV: - This command will allow you to enter 
almost any dos command straight from the Atari keyboard 
without ever having to leave EDIT 6502. ADRl is the 
command requested. ADR2 should be entered as a zero unless 
otherwise requested. The XIO command is very simular to 
the basic XIO command. 

There are 5 sub-commands used in this command. They are: 

1. 20 or .32 is rename 

XIO 20, 0 "D:FNAME1.EXT,FNAME2.EXT" 

2. 21 or .33 is delete file XIO .33, 0 "D: FNAME. EXT" 

3. 23 or .35 is lock XIO 23,.0 "D:FNAME.EXT" 

4. 24 or .36 is unlock XIO .36,.0 "D:FNAME.EXT" 
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VIII. SYSTEM MANAGEMENT 

The methods of system management ace very flexible in allowing 
the user to be able to relocate source, object, and the symbol 
table. With this flexibility, comes the responsibility of the 
user to set the addresses so that there are no conflicts in 
addresses. Failure to follow this procedure could result in 
having the source overwrite the symbol table or some other 
i undesirable result. 


1. NEW NONE - Clears current source file in memory and symbol 
table. Will ask for verification of OK TO CLEAR (Y/N). 
typing Y will clear everything; any other character will 
take no action. 

2. CLR NONE - Clears the symbol table. 

3. LEN NONE - Returns starting address (in hex only) and length 
of the source file, free space left, and symbol table in 
memory in both hex and decimal. The starting address is 
prefixed with a A$. The hex length is prefixed with a $. 

4. LOM [ADR1 ] - Resets the pointer for the beginning of text. 
This command will do an implicit NEW after receiving 
verification from the user# When no address is specified, 
the lomem reverts to the default address of $1000 above 
APMLO is used. If DOS and the disassembler are present, 
this defaults to $3100. If no DOS is present the value is 
$1700. If you have the disassembler present and place the 

r value below $2100, the disassembler will no longer be 
usable. If the user decides to not verify in response to 
that question, the lomem value will not change. 

5. HIM [ADRl] - Sets the top of working memory in which the 
SOURCE file can be manipulated. When no address is given, 
the value of $A01 bytes below screen memory is used (for the 
default object to reside above it). When text is buffered 

£ (as in an insert, edit, or copy) the text is moved up to 

'% from himem down. It is important that you reserve space 

above himem if you plan to place the object or the symbol 
table there. 


< 9 > 


EDIT 6 5 0 2 


6 . SYMB [ADR1] - Sets the starting location of the symbol table 
in memory. This command sequence does an implicit CLR. 
When no address is given, the symbol table is defaulted to 
start at the value given in APMLO ($2100 with the 
disassembler present). 

7. TABS (LNOl] I,LN02] [ ,LN03) - Sets the tabs for listing and 
assembly. Tab field one (LNOl) is the opcode, field two is 
the operand and field three is the comment field. Any or 
all parameters can be passed to this command. If the 
parameters are 0's, the listing will come out unformatted. 
If no parameters are given, the default values of 10, 15 and 
28 are used. Please notice that tab field one actually 
contains the length of the label field. When editing basic 
programs, use the command TABS 0,0,0 before listing the 
file. 

8. DATE NONE - Changes system date in case of a typographical 
error upon entering the date originally. 

9. HELP NONE - displays on the video screen all of the commands 
available from the command control processor. 
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IX. EDITING COMMANDS 

The format of data entry is essentially free form, however ther*£ 
are some exceptions. The first character of a line should 
either be a space for no label, an '*', or a for a line 

that is an entire comment line, or an alpha character for a 
label. Spaces are used to separate the fields, .and you can 
insert one or more of them between fields, it doesn't matter to 
the system. Insert only one space between fields with the 
exception of the placing of 2 spaces between the opcode and 
operand fields on opcodes with implied operands, such as INX, 
PHA etc, to insure the good appearance of listing formats. When 
used with implied operands, the shift opcodes ASL, LSR, ROL and 
ROR, require the addition of a ; between the opcode and tire 
comment field to tell the assembler that the addressing mode is 
implied. Labels can be any length, but it is a good idea to 
keep them under 10 characters for the listing formats to look 
proper. Table V shows some typical input examples. 
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ASSEMBLY INPOT EXAMPLES 


Note: the underscore (_) has been used in place of a space for 
reader clarity. 


1. ) TEST LDA_FLAG_check_to_see if.flag_set 

2. ) _ASL_;times 2 

3. ) TEST 

4. ) _LDY_#STRING1-STRING-1 print_string_in_inverse 

5. ) LOOP_LDA_TABLE,X_get_next_value 

6. ) _CMP_(CHAR),Y 

7. ) _DSS UP,LEFT,RIGHT,RTS1,DOWN cursor move_stack 

8. ) CH EQU $24_cursor horizontal 

9. ) TEST_INP_"MEMORY IN K -> " 
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1. ADD NONE - Appends source file in memory from keyboard 
entry. EDIT 6502 will keep accepting input until a CR 
(carriage return) is entered as the first character of the 
line. The system will continually prompt with line number* 
for each line. If a line is aborted (SHIFT DELETE), the 
prompt will now be 'A> 1 . 

2. EDIT (LNOl][,LN02] - Edits one or more lines of text. Each 
line will be displayed with the cursor pointing at the 
first character past the line number. To abort the edit 
mode without altering that line, press CTRL-A at that 
point. Alternate prompt in this mode is 'E>'. 

3. INS [LNOl] - Inserts text in source file before LNOl. 
System will keep accepting input up until a CR is entered 
as the first character of the line. User will be prompted 
with line numbers. All text, after the insertions, will 
have their line numbers raised accordingly. Alternate 
prompt in this mode is 'I>'. 

4. DEL [LNOl] [ ,LN02] - Deletes from the source file either a 

single line (LNOl) or all lines inclusive from LNOl to 

LN02. If no line numbers are given, all lines of text will 
be deleted. 

5. FIND [LNOl] [ ,LN02] "STRING1" - Allows you to find all 

occurrences of the ASCII string STRING1 in the current 

source file from the ranges LNOl to LN02. If no line 
number is given, FIND will search the entire file. 

6. CHNG [LNOl] [,LN02] "STRING1"STRING2" - Changes all 

occurrences of STRING1 to STRING2 in the range of line 
numbers given. Note the requirement of only three 
delimiters for the string separations. 

7. SRC H [LNOl] [,LN02] "STRING1"STRING2" - Similar to change 
except that the user is prompted when each occurrence of 
STRING1 is found. To change STRING1 into STRING2 press any 
alpha character? to not change, press any control 
character. ESC is especially handy for this. This command 
is a SELECTIVE change. 

8. LIST [LNOl][,LN02] - Lists source file on the video screen 
in the ranges of LNOl to LN02. Listing will be formatted 
according to tab settings. If no line numbers are given, 
the entire file will be listed. If only one number is 
given, only that line will be listed. 
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9. PL1ST [LNOl ] l, LN02 ] - Same as list, but the output is sent 
to the printer. 

10. COPY LNOl,LN02 TO LN03 - Allows for the movement of text. 
It will copy the text in the range of LNOl to LN02 and 
insert it in the lines preceding LN03. This function uses 
the symbol table as a buffer, so it does an implicit CLR. 
The original text will remain in LNOl to LN02, although the 
line numbers may be changed from the insertion, as well as 
being- copied. 

11. TABLE NONE - Prints current symbol table in memory to the 
video screen. 2 entries per line will be printed. 
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X. MODE CHANGERS 


1 . 


2 . 


MON NONE - Enter machine language monitor. See the monitor^ 
section for a detail of the commands and their usages 
Command prompt for this mode is 1 M> 1 . 

DIS ADRl, ADR2 "STRING1" - Enters 2 pass disassembly mode. 
ADRl and ADR2 represent the starting and ending *^ resses °£ 
the entire disassembly for the purposes of 



has to be loaded in the wrong area of memory. ri 9 
just a reference header that will be placed in 
Command prompt for this mode is 'D> 1 . 

ASM [PLTSWA" ] - Assembles file in memory. If lin *® are “ S wp 
in the file, then more than just what is in memory can be 
assembled. PLTSWA are assembly time toggle switche 
can be set at your convenience. The switches 
default settings are: 


P. 


L. 


T. 


S. 


W. 


goes 

send 


A. 


Printer. Default is off. Listing normally 
to the video screen; using the P option will 
the listing to the printer. 

Listing. Default is on. Listing normally occurs. 
Using the L option you turn the listing .&££. This 
switch can be changed in the assembler as well. 
Table. Default is off. The symbol table is 

normally not printed. This option allows the 
symbol table to be printed only on a successful 

Stor e^ ly Def a u 11 is on. The object code is 

normally stored. By toggling this switch, the 
object file will not be generated unless the 
option is used which sends the object to the disk. 
Wait. Default is off. This is a wait on errors 
flag. User will be signaled errors with a message 
and a bell. If the wait flag is set, he will be 
prompted to hit a key before resuming the 

assembly. ... . _ 

Abort. Default is off. This is an abort on 

errors switch. If set. all assemblies will abort 
when an assembly time error is encountered. 

The other option of " must be used as the last 
option and is the start of the object file name to 


< 15 > 


save the object to disk under. No other delimiter 
to start the name other than the quote (") may be 
used here. 

GO ADR1 - Executes directly the program in memory starting 
at address ADR1. 



EDIT 6502 


XI. MACHINE LANGUAGE MONITOR 

The machine language monitor can be entered by typing MON <CR> 
from the command control processor. When the monitor is-' 
entered, the prompt now becomes * M>'. The monitor is an outer 
level command module in that hitting the [BREAK] to abort from 
in the monitor will return you to the monitor. Entry of 
commands to the monitor is different from the command control 
processor in that the parameters (usually addresses) are entered 
before the command, all commands are single letters and multiple 
commands can be input on a single line. 

All parameters are 16 bit unsigned numbers with wrap-around. On 
inputs of larger than 65535 decimal, the most significant digit 

is thrown out. All numbers entered as parameters can be 

expressions. Mathematical operators supported are: +-*/ for 
addition, subtraction, multiplication, and division 
respectively. No precedence is taken with expressions, just 
simple left to right evaluation. Three parameter entry is 
3<2,1. Two parameter entry is 2,1. Single parameter entry is 1. 
Entry of extra parameters is just ignored. Default radix 
(number base) is hexadecimal with decimal numbers supported by 
preceding them with a period (.) and binary numbers supported by 

preceding them with a percent symbol (%). 

For the following discussion, parameters will be discussed as 
3<2,1. The syntax of the description will be command letter 
followed by the number of parameters in brackets and a 
description of the command. If no parameter is entered, the 
last used value will be used. 
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XII. COMMAND SET FOR MONITOR 


- <1> Hex result. Prints the result of 
as a 16 bit hex number. 


parameter 1 


(expression) 


S <1> Decimal result. Prints the result of parameter 1 as a 16 
bit decimal number (0-65535). 

? <2> n=r? la ¥* ? isplay in both hex and ASCII the memory from 
ji ame te r 2 .up to and including parameter 1. If only 

displ 6te d 1S entered ' onl y that memory location will be 


o. Jump to routine at parameter 1. If the routine ends 
RTS instruction, control will return to the monitor, 
he 6502 meta registers are restored to the 6502 registers 
Derore going to the routine. If no address is given, the 
last used PC address will be used. 

L <1> List. Disassembly (1 pass) the next 20 instruction and 
^- ls t the disassembly on the current output device. 

<2> ASCII Search. {‘.Search from parameter 2 to. parameter 1 for 
the ASCII string following the quote and ending in (but 
not including) the carriage return at the end of the input 
line. ^With this command-, multiple commands can not be 
entered on the input line unless they precede the search 
command. '* 

1 <2> Hex Search. Search for the hex string following the 
single quote. All hex entries are separated by commas 
(,). Same rules as to multiplicity of commands, applies as 
in an ASCII search. 


s <1> Hex store. Change the contents of memory starting at 
parameter 1 by inserting the bytes entered in the input 
line following the colon. Again the carriage return is 
the delimiter and all entries are separated by commas. No 
commands can be made after the store. 

> <1> ASCII store. Store the ASCII string in memory starting at 
parameter 1. Ending delimiter is the carriage return at 
the end of the input line. 

2 <3> Fill memory. Fill memory with the low 8 bits of parameter 
3 in the range of parameter 2 to parameter 1. 
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X <0> Return to Edit 6502. Returns user to Edit 6502 command 
control processor. 

# <0> Display 6502 Meta registers. Displays the 6502 stored 
registers (psuedo registers that are restored to the real 
registers every time a go is executed). Registers may be 
modified with hex or asc store commands without an address 
parameter being entered. But, to modify the Y register, 
you must enter the preceding values for A and X. 

W <2> Write sector. Writes sector parameter 2 (high byte is 
sector, low byte is track; ie, to write track $11, sector 
$F from $800 you type 'F11 , 800W') from data buffer at 
parameter 1 to the disk in current slot and drive. 

R <2> Read sector. Reads sector parameter 2 into data buffer 
starting at parameter 1 from the disk in current slot and 
drive. All sector buffers are 256 ($100) bytes long. 

P <0> Printer. Sets the printer as the current output device*. 
All output to the printer will be paginated with a 
heading, the date, and the page number. This mode will 
remain in effect until the N command is issued. 

N <0> Normal video. Return output device as video screen. 

S <1> Step. Execute one instruction at parameter 1 and display 
the 6502 registers. 

T <1> Trace. Continually steps through code. After each 
instruction the 6 50 2 registers will be displayed. 
Execution will return to the monitor upon receiving the 
BRK instruction (00) . Outputs can be paused with the 
space bar and halted (return to the monitor) by the break 
key ((CTRL C]). 

M <3> Move. Move the memory from parameter 2 to parameter 1 and 
place it in memory starting at parameter 3. 

V <3> Verify. Verify that the memory from parameter 2 to 
parameter 1 is the same as the memory starting ajt 
parameter 3. All non-identical locations will be printed 
with the corresponding data. 
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U <0-3> User. User extension of monitor commands. This command 
will jump to the user location $3F8 (where you can place 
the jump command to your routine). Parameters will be 
stored (low byte, high byte) as follows: parameter 3 — 
$88,$89; parameter 2 -- $84,$85 and parameter 1 -- 
$86,$87. The user location is not initialized with 
anything on bootstrap or reset, it i6 the user's 
responsibility to fill the location with a jump before 
using the U command from the monitor,. 

1 <0> Dos. Executes the DOS utilities package. 
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XIII. ASSEMBLY 


The assembly section of the program will set the toggle switched 
according to the parameters passed and will assemble the source 
file in memory, it will begin by doing an implicit CLR of the 
symbol table. EDIT 6502 supports all addressing modes of the 
6502 and includes 20 psuedo opcodes (or assembler directives) . 
This facilitates making the writing of assembly language 
programs easier. 

The default number base is decimal. Hexadecimal is supported 
when the number is prefixed by a * $' r and binary is supported by 
prefixing the number with a '%'. The program counter can be used 
by using the symbol ASC characters can be-used by 

prefixing them with a " or a 1 . The double quote (") sets the 
high bit, and the single quote (') clears the high bit. All 
operands can aiso be made up of combinations of the modes. 
Non-spaced separation of values by the characters +-*/ will 
perform the functions of addition, subtraction, multiplication, 
and division respectively. There is no precedence for 
operators; the field is read from left to right. For example, 
if we have the label HOME assigned to $FC5 8 and our operand 
looked like #HOME/256+$FB*%10-$100, EDIT 6502 would generate $FC 
(HOME/256), $1F7 ($FC+$FB), $3EE ($1F7*2) and finally $2EE 
($3EE-$100) . If the opcode were an LDA, the accumulator would 
be loaded with $EE in the immediate mode (#). 

The structure of addressing modes is basically standard with a 
couple of exceptions. Namely, the use of the implied mode on a 
shift opcode (ASL, LSR, ROL and ROR) does not require an A as an 
operand, but rather a blank field. The greater than symbol (>) 
will generate the high half of the value for an entire math type 
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operation. It will perform a divide by 256 of the final value. 
This is invaluable in loading the page of a software stack. For 
example, to get the page value of the label HOME, do a LDA 
#>HOME. 

The syntactic structure of the operand field for each addressing 
mode should look like table VI. 

A label can be the only thing present on an input line. In that 
case, the program counter will be assigned to the label and the 
assembler will go on to the next line. This can be a very handy 
feature when you are constantly changing the entry to the label. 
You can isolate it on a line by itself and not have to edit the 
label line. 

The assembly is done in two passes. The first pass collects all 
of the labels and places them in the symbol table. The second 
pass generates the actual code. Some .of the assembler 
directives are accomplished on pass 1, and some are accomplished 
on pass 2. At the end of pass 1, the symbol table, is complete. 
If you are assembling just to view that, you can abort the 
assembly [BREAK] at that point and use the TABLE command to view 
the symbol table. 
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TABLE VI 

OPERANDS FOR ASSEMBLY 

1. IMPLIED - No operand (should use two spaces before comment 

for tabbing to remain formatted). * 

2. IMMEDIATE - #VALUE where value can be any combination of 
labels and numbers as described above. 

3. ZERO-PAGE - VALUE where value represents a value less than 
256. For value to represent a label only, it must have 
been previously equated to zero-page (earlier in. the 
assembly) to .take on the zero-page addressing mode. 

4. ABSOLUTE — VALUE where value represents a value greater 
than 255. 

5. ZERO-PAGE INDEXED BY X - VALUE,X where value is <256. 

6. ZERO-PAGE INDEXED BY Y - VALUE,Y where value is <256. 

7. ABSOLUTE INDEXED BY X - VALUE,X where value evaluates to 
>255. 

8. ABSOLUTE INDEXED BY Y - VALUE, Y where value evaluates to 

> 255 . ; 

9. HBDIRECT PRE INDEXED BY X - (VALUE,X) value must evaluate 
to <256 or an error message will occur. 

10. INDIRECT POST INDEXED BY Y - (VALUE),Y where value must 

evaluate to <256 . . r 

11. INDIRECT - (VALUE) the only instruction using this mode is 
the indirect jump. 

12. RELATIVE - VALUE where the difference from value to the 
program counter (*) must be between -128 and +127. 

13. ACCUMULATOR - NONE. Remember to place two spaces in the 
listing for formatting tabbing and to include a j before 
the comment listing. 
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XIV. PSDEDO OPCODES 

t . 

There are 20 psuedo opcodes to EDIT 6 502 . Nine of them are 
genuine psuedo opcodes- in that they generate code. , The other 11 
are assembler directives which furnish the assembler information 
to assist in the easy generation of code. The 20 psuedo opcodes 
and their syntax are: 


1. BQO VALUE - Equates the label to the value VALUE. For 
value to'contain a label as part of it's make-up, the label 
must have been previously defined. ,S, 

2., ORG VALUE - Sets the origin of the assembly. This is where 
the' object code will reside when it i"3 to be run. If no 
ORG ..is given, the default value is $A00 below screen 
memory. On assemblies to disk, ohly one ORG directive can 

, be given. 

3* OBJ VALUE - Sets the object location of where the code will 
be assembled in memory. OBJ and ORG work totally 
independently for greater flexibility. This.is the 
location where the code will be going right now, even if it 
is not meant to run there. This allows for resolving 
conflicts of addresses by not having the origin space 
available at time of assembly. If no OBJ is given, the 
default value is $800 below screen memory. 

4. PAG or PAGE none - This directive will generate a form feed 
to the printer on pass 2 of the assembly. 

5. LST ON or OFF - This directive will turn the listing option 
on or off depending on the parameter in the operand field. 

6. IBP ["STRING1"] - This directive, during pass 1 of the 
assembly, will prompt the user with STRING1 for input to be 
equated to the corresponding label on the same line. Input 
radix is defaulted to hex (decimal prefixed with . and 
binary with %), and no math is allowed on value. This 
procedure is very convenient when asking during assembly 
time for the parameters of a conditional assembly. The 
delimiters on the prompt string must be quotes ("). 
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7. LNK "DEV:FNAME.EXT" - This directive allows you to 
assemble source files that are too large to fit in the 
Atari's memory at any one time. The original file in 
memory at the start of assembly will be saved under tha* 
name of 1 D:TEMP' so be sure to not have a file of value bj^. 
that name on your disk. Any number of source files can be 
linked on any one assembly. This directive can only be* 
done with a disk system. 

8. RES VALUE - Reserve storage for value bytes of memory. The 
assembler will not place anything in this space, but will 
skip over it. On assembly to disk, nulls will be used m 
the area. The maximum value for RES is $FF bytes. 

9. DFB VALUE [,VALUE] etc. - Define byte. Will take the low 
order byte of each value and store it in memory. Multiple 
arguments are supported when separated by a comma. 

10. DFW VALUE [,VALUE] etc. - Define word. Will store a 16 bit 
address in standard 6502 low byte, high byte -format. 
Multiple arguments are supported when separated by commas. 

11. DPS VALUE : [,VALUE] etc. - Define a multiple page software 
stack. This directive is similar to DFW with the exception 
that 1 is subtracted from each argument for software 
stacking. Multiple arguments are supported when separated 
by commas. 

12. DSS VALUE [,VALUE] etc. - Define a single page software 
stack. Similar to DFB with the exception that 1 is 
subtracted from the low byte of the argument. Multiple 
arguments are supported when separated by commas. 

13. ASC "STRING" or 'STRING' - Store ASC string in memory. 
For listing formats to look proper, you should use the 
double quote as often possible. If single quotes are used,' 
any space in the operand will force the rest of the operand 
over to the comment field on listing. 

14. DCI "STRING" or 'STRING' - Same as ASC with the exception 
that the last character stored has the high order bit 
inverted. 

JC 

15. VTl "STRING" or 'STRING' - Define text zero. This is as 
ASC command with a null byte appended to the end of thr 
string. 
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16. iwv "STRING" or 'STRING' - Similar to ASC with the 
exception that the ASC string is stored in memory in the 
inverse order of how it is listed in the operand. 

17. TLE "STRING1" - Place stringl as the page header for 
assembly output. The header is placed during pass 1 of the 
assembly; so, if you have more thanl tie command, the last 
one will be printed on all pages of the assembly listing. 
Page headers on printouts will also include the date and 
the page number. 

18. IFC VALUF, - If, condition. If value equates to any non-zero 
value, the assembly will continue until an ELS directive is 
encountered. If value equates to 0, then no code will be 
generated until an els or an end command is reached. 
Conditional assemblies cannot be nested. So be certain to 
enter'-an END directive before issuing another IFC 
directive. 

19. ,ELS - $lse condition. If the conditional flag was set to 
„ofalse,»it is now set to true and vice versa. If an ELS 

directive is encountered before an IFC directive, it will 
;turn off code generation up untiBUan IFC or an END is 
->encountered. - • :/'■ 

20. EHD - End condition. Force code to be generated from now 
until another IFC is encountered. 
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XV. DISASSEMBLY 

Before ever entering the disassembly mode, we must first 
determine what portions of the data to be disassembled are c °deT 
data, words, and stacks. This is accomplished by using memory 
dumps and single pass disassembly in the monitor. A straight 
shot at using all code in a two pass disassembly will generally 
work, but will usually generate some meaningless labels that may 
not work if the code is relocated elsewhere when reassembling. 
Separating ASCII text from hex data is merely a matter of 
determining that the section in question is indeed data and 
doing an ASCII dump to determine the portions, if any, that, are 
ASCII data. 

The disassembler never clears the text or symbol table areas of 
memory. In this way, you can disassemble 

labels . Long disassemblies that are larger in length than the 
source area can be accomplished by disassembling a section, 
returning to the CCP, and typing 'DEL 1, <CR> 1 . This will clear 
the text but will' leave the symbol table intact. Reentry to the 
disassembly mode does not clear the symbol table to allow the 
freedom of disassembling large bodies of code. 

to enter the disassembly mode, type DIS ADR1,ADR2 "STRING1". 
Where ADR1 and ADR2 are delimiting values for where equates are 
placed in the file. They do not have to correspond to the 
actual area of memory being disassembled (they, generally do 
unless the code is not in its usual location). The STRING1 is a 
name identity that you may select for your ease of understanding 
of what the file is about. You will now be rewarded with a 
prompt of ’D> 1 . Commas (,) is used as an address delimiter and 
spaces are ignored. There are five parameters that can be 


< 27 > 


EDIT 6502 


passed to the disassembler. They are: L-6502 list (disassembly 
of standard 6502 code); T - ASCII data (character strings); H - 
Hex data (DFB opcodes); W - word data (DFW opcodes) and S - 
Stack data (DFS opcodes). The format afrua line looks like: 

. Sil&r. -<V. 

D>ADDR1 , ADDR2 (param) ,ADDR3 (param) ,ADDR4i>tparam) etc. 

: , 

Where ADDR1,'ADDR2, ADDR3 and ADDR4 stand, defined on page 9 and 
(param) stands for L, T, H> W or S.- ' Fort example, if there was 
code from $800-$900 that we wished to disassemble and we had 
already determined that from 800 to 83 2 twas 6502 code. 833 to 
858 "was ASCII text. 859 to 86A was hex data. 86B to 8C1 was 6502 
code, 8C2 to 8F3 was Stacks, and 8F4 to 900 was 6502 code, our 
entry line would look like this: 

- 1 ' . •/ 19V' 

D>80 ? 0 /83 2L, 858T, 86AH, 8G1L,8F3S,900L v ,^6 , 

' ■* •' ... J 

The following is a scenario of a long disassembly. 

First we did a NEW and cleared the entire text. Then we had the 
optibn of entering .arid assembling (we must get those labels to 
the table) a file made up of equates for the disassembly file. 
Then we entered disassembly mode by typing DIS and its options. 
We disassembled a large portion of code and .found ,t*hat we were 
nearing the Memory limits of the machine. Wes exited disassembly 
•by pressing the return key as the first character of a line, got 
'•v to the editor dWd saved our first portion of the text. We 

; ‘"then did a DfiL<CR> fed-delete 1 all text (but kept our symbol table 
irftact), reentered disassembly mode (DIS) and were able to 
continue without refilling our text with redundant equ's (that 
also cause assembly errors). We could then go on our merry way 
continuing the disassembly where we left off before. 
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When we hit the return key at the end, we would see two passes 
o£ the code flashing before our eyes and the file from 800 to 
900 would be disassembled. We would then be shown the length o^ 
our file (to determine if memory is getting full) and b^, 
returned to the disassembly mode (prompt D>) . T-o exit the 
disassembly mode at this point, we just press the- return key. 
We can then go back and edit, list or assemble our newly created 
source file from the disassembly. 

Not all disassemblies will reassemble directly. The use of 
labels in the middle of instructions and data is a common 
occurrence. For example, the loading of a multiple page 
software stack is accomplished by: 

-4» 

GO ASL ;times 2 , t 

TAX for indexing 

LDA MSTK+1,X page byte 

PH A ' V U 

LDA MSTK,X low order byte 

PHA 

RTS to sub via rts 

The loading of A from MSTK+1,X will almost always generate an 
assembly error because the data in MSTK will be done on an eight 
wide basis. 

Simple editing of the loading labels can correct this problem 
before reassembling the text. 
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Another potential assembly problem of disassembly listing is the 
use of the BIT opcode ($24 and $2C) or 1 other branch never type 
instructions to get the program to skip„.over a load or store for 
the purposes of saving code.- An exantpilje of this wouid be the 
setting or*' resetting of a flag dependif®iP.n=..conditions met. To 


illustrate: 

- 

■■ l ‘ airii 

; - 


• ins, ■ o 

TEST 

CMP EQUAL 

the test com&itipn • 


BEQ GOOD 

passed test! 


LDA #$FF 

set flag, failed 

rn 

DFB $2C 

skip over nexte : LDA 

GOOD 

LDA #0 

signal good test 


STA FLAG 

’ i i. 

. ^ C * 

V 

,n c. /. * 


In either instance, the value in A was:r«fcored in the label FLAG. 
If the test passed, the value stored was a 0, if it failed, the 
value was $FF. ... . 


n ■«- 


. I Cv. 


XX+HT2M X*I 

To correct a problem like this, again simply\editing the text 
will do it. If the information had beeii previously known, the 
disassembly could have supplied the byte before, the label GOOD 
as being hex data as it was generated when disassembling 
originally. * 
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' APPENDIX A. 

EDIT 6502 MEMORY MAP 


MEMORY AREA 

j ir 'IE 

USER SPACE 

$0-$7F 

ox$TEM POINTERS 

NO 

$80-$B6 

'• EDIT 6502 POINTERS 

. NO 

$B7-$FF 

1 EREE 

YES 

$100-$1FF 

6502 STACK 

NO 

$200-$47 F 

SYSTEM POINTERS 

NO 

$2D9-$2DA 

BLOAD ADDRESS 

:no 

$2DB-$2DC 

3LOAD LENGTH 

NO 

$480-$57 F 

INPUT BUFFER 

YES 

$580-APMLO 

SYSTEM POINTERS 

NO 

APMLO-SVMSC 

— * uSLR SPACE 

- YES 

SVMSC-HIMEM 

- VILDO SCREEN 

NO 

$AOOO-$BFFF 

EDIT 6502 

NO 

$D000-$FFFF 

OPERATING SYSTEM 

NO 


Zero page locations of particular consequence are: $2C9 text 
buffered flag, $78 current output stream (0 for video), $64-$67 
video screen pointers, $9C-$9D system lomem, $9E-$9F system 
himem, $8A-$8B symbol table pointers, and $82-$83 end of text 
pointer. 
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Some useful entry points for trying out routines are: 

COUT EQU $B86E output character in A to current 

output device 

RDKEY EQU $B915 obtain ter w/cursor-q^ ; 

. _ . -from ..cur .rent. -input. -device_ 

GETLN EQU $B7C9 • «•;? .start withrapr then prompt 

GETLNO EQU GETLN+3 with prompt,, but no cr 

GETLN1 EQU GETLN+$E no prompt nnless cancelled 

BLANK EQU $B83F output a space 

CROUT EQU $B843 output a carriage return 

PRBYTE /'EQU $B85B hex print byte in A to current 

output device 

PRDEC EQU $A62A output a 5.digit decimal to current 

... -, output 'jdev.ice 

CLS EQU $B6ED clrjs^rj^ciw^p and home cursor 

PUTLN EQU $B95E VWMt> t§#t A from A,Y to a CR or NULL 

~.... "'VZ2 

M3T2Y3 TlTtr-l 


' * - s • 1 * • ’ - IX i / 

fctl . * • I r 
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J,J - APPENDIX B. 

' • *.V1:j 

:~>XT 6502 ERROR MESSAGES & 

i . ' V ■ • 

PAST END — The 1 ii. iK't .sr or rang^ cf line numbers extended 
beyond the range of the file. 

- Cl: ' . of S-'l. - . 

FORMAT -- Number^ were out of range or the format of an operand 
was not correct. 

SYNTAX — The com mar. J ^ was unrecognized by the system. Either 
the command is not jwed, or there is a misspelling. 

DOP LABEL -- There was more than one occurrence of a label 
definition for the ■i't label. 

INVALID OPCODE — The opcode was unrecognized as being either 
6502 or a psuedo opcode. 

LABEL RBQU1 — Either an equate or input psuedo op has been 
used without a label associated with them. 

BRANCH OOT OF RANGE — The branch address was not within -127 or 
+128 of the program counter. 

ILLEGAL ADDRESS MODE -- The mode of operation for that 
particular opcode is not in the 6502 opcode set. This can also 
occur if a zero page label has not been equated to zero page and 
an indirect instruction is used. 

UNDEFINED LABEL — A label was referenced that was not defined 
by an equate or a program location. 
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OOT OP MEMORY — The systems memory could not handle the last 
line entered. If the text had been buffered (as in an insertion 
or edit) all will; beu,res.to.r.ed with fclraaexception of the last 
line entered. The Len command may say that there are a few 
bytes left; but not; engu^i-feor t&e ‘ 90 fcKjfl%fj.j?.ne•— 

,olil erid lo spnso itlJ bno*/'?'! 

RANGE — Either a himem parameter was too high, line numbers 
wenjt; from high to.low (e.g* 100,50) tQg vaptipn.speci^^d a 

drive outside the range allowed. 

I/O CODE: — An, I/O operation was atfcegfl^ed and an error was 
received. The number following the.mq§j$jge-* will be a standard 
Atari error code. 

j .j :-jtoo one r 1 • 5 ).u z&v or - 

NOT A LOAD PILE — File trying t_<>,.<be ^jft&dqd is not an Atari 

object file. 

*‘j a; 0 %Ain •>009 0 nu r .sv jbooqo ariT -- ■ >i . 

. ofcooqo obeuaq - , 

• . - CKfllUOil *3t£AT 

••>335 '? 1 . -cadiv?;--; 

■f - : . X 

.. <._+ 

- Hd-i • 

■ ‘ > • .. 

I ICt.. j t .. "U. d -' ■'*'.< u ; S 

I'josf. a •- w-iv w »..»«• if.j 

v : ?< 10 -> • r ; " 7 -te y4 
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or> APPENDIX C. V n. - 

SOFTWARE STACr.iN j * 

.■ i ' j v. . L . . j 1 ,»u ...... * 

Software jstaeKing. ,?./4 &.term used ; to, emulate the missing jump 

r 

indirect indexed jjts; uction. How this is accomplished requires 
the user to understa 1 exactly how the 6 502 microprocessor 
operates an: RES' im?c/ jution. When an RTS is encountered, the 
6502 will pull firojir ^s stack two bytes and place them in-its 
program counterblow -'.te and then high. byte. Then the program 
counter is INCREHE1V:._D3Y ONE and the 6 50 2 fetches the next 
instruction. By pujshj^ng onto the 6502 stack the value minus one 
of the place one wi^iias to go in memory t the user cart then 
execute an RTS to^jujmv: to the place he wishes to go. These 
values are usually ]£.&■■ : d off .of, a stapic of addresses indexed by 
one of the indft^ffefl^i .ars (X or -Y) c ;r thus the term, software 
stacking. ■_* srjb .-jo aeac? f.-.. ;.•» • • j. c - 

This stacking can be done in one of two ways. The first way 
requires jail:,'routines. that are used in the: stack, reside on THE 
SAK> 'PAGE of memory. In this way,- the stac k- only - needs to 
- contain 'the low order .byte, minus on* , of the addresses of the 
~routines to be accessed. The page byte (common to all of these 
.routines) ‘is pushed on the 6502 stack first (so it can be pulled 
last) and the indexed byte is then pushed on the 6502 stack. 
The .RTS is then executed, and the routine is carried out. In 
examining this procedure, one must use caution. Scrutinize the 
results; if the routine to use starts at the beginning of the 
paq& (i;e.. byte-00). Tne stack will contain the. byte minus 1 or 
$FF, and .-when pushed;,, wilitactually be on the stack as the end 
; of the page. :When pulled off of the stack, by the RTS, the 
t.entire word will be ;incremented and the routine will not execute 
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as expected but, instead,- the program counter will be one page 
too high. Because of this, the range of starting addresses for 
single page stacks 01 to d$. Note that 00 is the 

address of the start of the next page, but this will work for 
the very same reason ,J t'hfet 3 thfe'00 By^Of i M»eP < tWrt%llfc .’will 

not. "j -i c iciij woH ,no ilouifani b^xcbni iosiibni 

- ; '. 'i i wo.i .* C.»ocx3 bfifeia-jsbn j .v» uaa 
The "‘second type of software’stack .allbDMBJ Wg&i ir o'lStl nes .to .reside 
anywhe're in memdry-.' Here: the ’index'- teegStitaiPlife multiplied by 2 
-because there are-2 bytes? per stack ;erttiT$dr wounds the high order 
byte, the plus X entry, ifr 1 loaded'by GJJfffrttfflfction similar to 
•XjDA STACK+1,X and 'pushed- on the 6502 sKWefeVl Then the low order 
byte is loaded'eind pushed !7T bef ore the executed. The 

advantage of- this 1 are dtfvioHils in thaV 9W* Croutines can reside 
anywhere in-#emb¥y.^ Th¥ i:; disadvant :i a-ge^Eji6ft£ ifiL the fact that the 
stack must 1 be twic£-’fis 1 loh-g for-a nuJhber of routines, 

and the code to push the stack addresses on the 6502 stack must 
be longer. 

.v- f . .i •< > v/ o v- >o :,;i . >ioso r.*z onijlosis &j -.1 ; 

Perhaps-the 1 user* woTide fS if : the r ’results’?ar el wiblet he aid. »the 
constraints--required to^do* this kind of manipulation^iWEhdlfeVare 
several‘f-e^bohfe for the-answer's being-’'yes i One* the'.speedo of 
execution is geheYaTly much -faster than ^doing several..compares 
and jumps. --Twc, the-'amount of code" req ui red’‘for saicb^ an 
operation'is usua-liy-imuch smaller' than the compar'e^^ump 
technique.' ' And third/ single page stacking is partihhterly 
effective for a short- number of routined where: comparisons-’ do 
not have tic be made based on the code • being - dn order^j.oFor 
example, to process control • characters' with'each' having'their 
own particular routine, no comparisons have*.iba be made-nonce'the 
character is'determined to be a control- character rbefote a 
particular control routine can be. accessed 1 To^ show wbat'vt.he 
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code would be, we might write for a single page operation 


"I..’. 00 i. 


• • ct■. •.: i; o > i 


: CMP #SP .b£t;sp or > is-,.ion Control 

mod i.;i;7 ) BCS n ' -TRL , not in the routine 

TAY only mifrus Values Work 

: - 0 ’ ’ - f M 3PL■ j i i I;0-T3IT .s,.ip,d£ plua > -ji 

4 '” char in A 

whatever we do to non controls 
get character to index 
push page byte first 


NOCTRL 

GOSUB 


TAY 

LDA #>PAGE 

PH A 03 U XIxw •,;< vi ) ■■ ■ 

LDA>isx-ACI^i$80, Y’ get byte ;from software stack 
PHA 
RTS 


It 

at 


■'••execute our routine -tor each control 


sO yd 'l-i 'y-s 


r ■» •* . . 

,<9 IS.£ 




< 37 > 




EDIT HW2 


-Jjcq Jigiiva ' ' . IW Jflpi 1 •;>:» 

Now 32 different routines have been accessed without ever having 
to see which control /Chiracterowe.had. As is often the case 
with 32 routines^.^(g^t/^^*«^)^88eB ^P^ch^putine could 
hardly be expected to f lit*lojn irinefiptoge. EflTOtiMng.e'Itthis routine 


to a multiple page' 


** re ^a8 h ^ 


'e the gosub 


routine to as f olloWsfb ow is-.oisriw . 

>C:« ::J 'J ’3 d 33 ( j 1Z} Y.V* 

j.-ivc! ‘.in -. , i!<?.:; r j 30A1< 4 AGi 

GOSUB ASL .-control *2 will also ah! 

r )- /‘r ; vo-?;r.em«!ive mstr,^S2beitJig’^i i gh[ 

TAY * Wi 

• LDA: j ST;ACK-bl)>iY ;ugeb-^paig«-jbyte 

PHA 

LDA STACK,Y and low order byte 
PHA 

RTS and execute 


JHT00/1 
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